BatchPixel Documentation

All-in-One Media Conversion Suite with Batch Processing

Introduction

BatchPixel is a powerful, client-side media conversion tool that allows users to convert, optimize, and enhance multiple images simultaneously. With support for 10+ image formats, advanced batch processing capabilities, and a privacy-focused approach (all processing happens in the browser), BatchPixel is the perfect solution for photographers, designers, and content creators.

Privacy First: All image processing happens directly in your browser - we do not upload any images to our servers. Your files never leave your computer.

Why Choose BatchPixel?

Lightning Fast Processing

Our optimized conversion engine can process hundreds of images in seconds with AI acceleration and Web Workers for parallel processing.

Advanced Controls

Fine-tune every aspect of your images with our comprehensive adjustment options including quality, dimensions, filters, and more.

Wide Format Support

Convert between all popular image formats including JPG, PNG, WEBP, GIF, SVG, HEIC, and even RAW formats.

Key Features

Explore the powerful capabilities of BatchPixel

Core Features

Conversion
Optimization
Enhancement

Batch Conversion

BatchPixel supports conversion between all these formats:

Format Description Features
JPEG (JPG) Lossy compression format Adjustable quality, progressive loading
PNG Lossless format with transparency Alpha channel, lossless compression
WEBP Modern format by Google Lossy/lossless, smaller file sizes
GIF Animated images Animation support, transparency
SVG Vector graphics Scalable, small file size

Image Optimization

BatchPixel includes advanced optimization features to reduce file sizes while maintaining quality:

Intelligent Compression

Our algorithm analyzes each image to apply the optimal compression settings, reducing file sizes by up to 80% without visible quality loss.

Auto Enhancement

The built-in AI enhancement automatically improves brightness, contrast, and sharpness for professional-looking results.

Image Enhancement

Transform your images with powerful enhancement tools:

  • Filters: Apply grayscale, sepia, vintage, invert, blur, and sharpen effects
  • Resizing: Scale by percentage or exact dimensions with aspect ratio locking
  • Rotation: Rotate images by 90°, 180°, or 270° with high quality
  • Color Space: Convert between RGB, CMYK, and grayscale color spaces

Installation

Get BatchPixel up and running in minutes

Installation Guide

Download the Package

After purchasing from CodeCanyon, download the ZIP package from your downloads section. The package contains all necessary files including HTML, CSS, JavaScript, and demo images.

Extract Files

Unzip the downloaded package to a directory on your computer. The main structure includes:

batchpixel/
├── index.html          # Main application file
├── assets/
│   ├── css/            # Stylesheets
│   └── js/             # JavaScript files
├── images/             # Sample images
└── documentation.html  # This documentation

Deploy to Server

Upload the entire directory to your web server. BatchPixel works on any standard web hosting that supports HTML5 and modern JavaScript.

No Server-Side Requirements: Since all processing happens in the browser, you don't need any special server configuration or PHP/Node.js.

Test the Application

Open index.html in your browser to verify everything works correctly. Try uploading and converting some test images.

Browser Compatibility: BatchPixel requires a modern browser (Chrome, Firefox, Edge, Safari 12+). For HEIC/RAW support, Chrome or Edge is recommended.

Quick Start

Get started with BatchPixel in 5 minutes

Quick Start Guide

Basic Conversion Workflow

Upload Images

Click "Select Images" or drag & drop files into the upload area. You can select multiple files at once (up to 10 files in the free version).

Upload Interface

Choose Output Format

Select your desired output format from the dropdown menu. Options include JPG, PNG, WEBP, GIF, and more.

Adjust Settings (Optional)

Customize quality, dimensions, filters, or other options as needed. Use the preview to see changes in real-time.

Process Images

Click the "Process Images" button to start conversion. The progress will be shown for each file.

Download Results

After processing, download individual files or get all images in a ZIP archive with one click.

Pro Tip: Use the batch rename feature to automatically organize your converted files with consistent naming.

Interface Overview

Learn about BatchPixel's user interface components

UI Components

Main Interface Elements

Upload Area

The drag-and-drop upload zone supports multiple file selection and shows supported formats. Files can be added by clicking or dragging.

Conversion Options

This panel contains all conversion settings organized into logical sections: format selection, resizing, filters, and quality adjustment.

File Table

Displays all uploaded files with thumbnails, original info, and processing status. Files can be previewed, removed, or downloaded individually.

Preview Panel

Shows side-by-side comparison of original and processed versions with detailed statistics about the conversion results.

Advanced Options

The "Advanced Options" section (accessible by clicking the gear icon) provides additional professional tools:

  • Color Space Conversion: Convert between RGB, CMYK, and grayscale color spaces
  • DPI Resolution: Set the DPI (dots per inch) for print-ready images
  • Watermarking: Add text watermarks with customizable position, size, and colors
  • EXIF Data: Choose to preserve or remove EXIF metadata from images

Converting Images

Detailed guide to image conversion options

Conversion Settings

Output Format Options

BatchPixel supports conversion between these formats with these specific options:

Format Options Best For
JPEG (JPG) Quality (50-100%), Progressive loading, Baseline optimization Photographs, web images
PNG Compression level (0-9), Transparency, Interlacing Graphics with transparency, lossless quality
WEBP Lossy/lossless mode, Quality, Alpha channel Modern web use, smallest file sizes
GIF Color reduction (32-256 colors), Dithering Simple animations, small graphics

Quality Settings

The quality slider controls the balance between file size and image quality:

  • 90-100%: Best quality, larger files (recommended for print)
  • 70-90%: Good balance (recommended for web)
  • 50-70%: Smaller files, noticeable quality loss
Pro Tip: Use the "Optimize for Web" option in Advanced Settings to automatically apply the best compression settings for web use.

Batch Processing

Efficiently process multiple images at once

Batch Operations

Batch Renaming

BatchPixel includes powerful batch renaming capabilities using pattern templates:

photo_{num}.jpg → photo_01.jpg, photo_02.jpg, etc. product-{date}.png → product-2023-06-14.png image_{time}.webp → image_14-30-22.webp {original}_converted → landscape_converted.jpg

Available placeholders:

Placeholder Description Example Output
{num} Sequence number (01, 02, etc.) 01, 02, ..., 10
{date} Current date in YYYY-MM-DD format 2023-06-14
{time} Current time in HH-MM-SS format 14-30-22
{original} Original filename without extension landscape (from landscape.jpg)

Batch Download

After processing multiple images, you can:

  • Download individually: Click the download icon next to each file
  • Download as ZIP: Get all files in a single compressed archive
  • Share directly: Use the Share button to send via email or social media (browser-dependent)

Advanced Features

Professional tools for power users

Advanced Tools

Resizing Options

BatchPixel offers three resizing methods:

Percentage Scaling

Scale images by a percentage (e.g., reduce to 50% of original size). Aspect ratio is maintained automatically.

Exact Dimensions

Set specific width and height in pixels. Choose whether to maintain aspect ratio or stretch to exact dimensions.

Preset Sizes

Quickly resize to common dimensions like Social Media (1200x630), Thumbnail (150x150), or Mobile (640x960).

Image Filters

Apply professional-grade filters to all images in your batch:

Filter Description Use Case
Grayscale Convert to black and white Classic photography, artistic effects
Sepia Vintage brown tone Antique/old photo effect
Vintage Combination of sepia and vignette Retro styling
Invert Reverse all colors Creative effects, negative images
Blur Soft focus effect Backgrounds, artistic effects
Sharpen Enhance edge contrast Improve slightly blurry images

Watermarking

Protect your images with customizable watermarks

Watermark Features

BatchPixel's watermarking tool allows you to add text watermarks to all images in your batch with consistent positioning and styling.

Watermark Options

Text & Appearance

Customize the watermark text, font size (10-50px), text color, and background color with transparency support.

Positioning

Choose from 5 preset positions: Top Left, Top Right, Bottom Left, Bottom Right, and Center.

Live Preview

The watermark preview updates in real-time as you adjust settings, showing exactly how it will appear on your images.

Watermark Best Practices

Visibility vs. Intrusiveness: Find the right balance - your watermark should be visible enough to deter unauthorized use but not so prominent that it ruins the image.
  • Use semi-transparent backgrounds (e.g., rgba(0,0,0,0.5)) for better readability on varied images
  • Position in corners where it's less likely to be cropped out
  • Include your website URL or copyright symbol (©) for maximum protection

Customization

Tailor BatchPixel to match your brand

Customization Guide

BatchPixel is designed to be easily customizable to match your website's branding and style.

CSS Variables

The main color scheme can be customized by modifying these CSS variables in the style.css file:

:root {
    --primary-color: #6c5ce7;      /* Main brand color */
    --secondary-color: #5649d6;    /* Darker shade for hover states */
    --accent-color: #00cec9;       /* Accent color for buttons */
    --dark-color: #2d3436;         /* Default text color */
    --light-color: #f8f9fa;        /* Light background color */
    
    /* Gradient variations */
    --gradient-primary: linear-gradient(135deg, #6c5ce7 0%, #a29bfe 100%);
    --gradient-accent: linear-gradient(135deg, #00cec9 0%, #81ecec 100%);
}

Theme Options

BatchPixel includes built-in support for light/dark mode. You can:

  • Force dark mode: Add class="dark-mode" to the body tag
  • Auto-detect system preference: Use JavaScript to check prefers-color-scheme
  • Add custom theme switcher: The toggle in the UI can be moved or restyled

Localization

To translate BatchPixel to other languages:

  1. Locate all text strings in the JavaScript files
  2. Create a translation object with your language strings
  3. Initialize BatchPixel with your language option
// Example Spanish translation
const translations = {
    en: {
        uploadText: "Drag & drop your images here or",
        selectFiles: "Select Images",
        processing: "Processing...",
        // ... all other strings
    },
    es: {
        uploadText: "Arrastra y suelta tus imágenes aquí o",
        selectFiles: "Seleccionar Imágenes",
        processing: "Procesando...",
        // ... all other strings
    }
};

// Initialize with language
BatchPixel.init({
    language: 'es'
});

Troubleshooting

Solve common issues and errors

Common Issues

General Problems

Images aren't uploading properly

Possible causes:

  • JavaScript errors on the page
  • Files are too large (browser memory limits)

Solutions:

  • Update your browser to the latest version
  • Check browser console for errors (F12)
  • Try with smaller files first
Conversion is very slow

Image processing is CPU-intensive, especially for large images or batches. For better performance:

  • Process fewer images at once (5-10 instead of 50+)
  • Reduce output dimensions for very large images
  • Use Chrome or Edge for better performance
  • Close other CPU-intensive applications

Format-Specific Issues

HEIC/RAW files not working

HEIC and RAW formats require browser support and may not work in all browsers:

  • Chrome/Edge: Full support with proper EXIF data
  • Firefox: Partial support (may lose metadata)
  • Safari: HEIC works but RAW formats may fail

For best results, use Chrome or Edge when working with HEIC/RAW files.

Animated GIFs lose animation

When converting animated GIFs to other formats (except WEBP), the animation will be lost as most formats don't support animation. Options:

  • Convert to WEBP (supports animation)
  • Extract individual frames first
  • Keep original format if animation is needed

Getting Support

If you encounter issues not covered here:

Support Channels: Contact our support team via CodeCanyon messages or email support@newrize.com. Please include:
  • Browser name and version
  • Detailed description of the issue
  • Steps to reproduce the problem
  • Screenshots if applicable

Frequently Asked Questions

Quick answers to common questions

FAQ

Is there a file size limit for images?

BatchPixel can handle large images, but browser memory limitations apply. As a guideline:

  • Recommended max: 10MP (e.g., 3000x3000px)
  • Absolute max: 20MP (may cause browser crashes)
  • Batch limit: 10 files at once (free version)

For very large images, resize them first before processing.

Does BatchPixel work offline?

Yes! BatchPixel is a client-side application that works completely in your browser. Once loaded, it doesn't require an internet connection to process images. The only internet requirement is for the initial page load and any external libraries (which can be downloaded for full offline use).

Can I increase the batch limit beyond 10 files?

The free version is limited to 10 files at once for performance reasons. To increase this limit:

  1. Purchase the PRO version (contact for details)
  2. Edit the MAX_FILES constant in script.js (not recommended for production)
Warning: Processing many large files may crash the browser tab due to memory limitations.
How do I update to the latest version?

Updates are available through your CodeCanyon downloads. To update:

  1. Download the latest version from CodeCanyon
  2. Back up your current installation
  3. Replace all files with the new version
  4. Test thoroughly before deploying to production

Check the changelog (below) for update notes.

Can I use BatchPixel on my commercial website?

Yes! Your CodeCanyon license allows you to use BatchPixel on:

  • Unlimited personal projects
  • One commercial website (per license)
  • Client projects (if you're a developer)

For SaaS or multi-site use, please purchase additional licenses or contact us for extended licensing options.

Changelog

Version history and updates

Version History

v1.1.0 June 2025
  • Changelog Will appear here

Support

Get help and resources

Support Options

Documentation Resources

Before contacting support, please check these resources:

  • This documentation: Covers all major features and common issues
  • Video tutorials: Available on our YouTube channel
  • Community forum: Discuss with other users on CodeCanyon comments

Contacting Support

For direct assistance, please contact us through:

Email Support

support@newrize.com (response within 7-12 hours)

CodeCanyon Messages

Use the messaging system on your CodeCanyon download page

For faster support: Include your purchase code, browser/OS details, and clear steps to reproduce any issues.

Custom Development

Need custom features or integration help? Our team offers:

  • Custom modifications: Tailor BatchPixel to your specific needs
  • White-label solutions: Rebrand BatchPixel as your own product

Contact support@newrize.com.com for custom development inquiries.